URLSetProperty

Sets the value of a property.



 
OSStatus URLSetProperty (

                     URLReference urlRef,

                     const char* property,

                     void* propertyBuffer,

                     Size bufferSize);

urlRef: A reference of type URLReference that identifies the URL that has a property whose value you want to set.
property: An untyped pointer to a null-terminated array of characters that specifies the name of the property you want to set. See Property Name Constants for the list of properties you can set.
propertyBuffer: A pointer to a buffer containing the value you want to set.
bufferSize: A value of type Size that specifies the size of the buffer pointed to by propertyBuffer . For more information on the Size type, see Inside Macintosh: Memory .
function result: A result code. For a list of possible result codes, see Result Codes .

DISCUSSION

The URLSetProperty function sets the value of a property that is associated with a URL. To clear the value of a property, set it with an empty character array.

The following properties, defined by Apple Computer, Inc., can be set:



 
kURLFileType

kURLFileCreator,

kURLUserName

kURLPassword

kURLHTTPRequestMethod

kURLHTTPRequestHeader

kURLHTTPRequestBody

kURLHTTPUserAgent